Markdown++ Authoring

For the full authoring guide, see Learning Markdown++.

Markdown++

The extended Markdown format ePublisher publishes. Its extensions ride inside HTML comments, so standard Markdown tools render Markdown++ documents cleanly.

Comment tag

The <!-- ... --> HTML comment container that carries Markdown++ commands. A comment tag stays on a single line and is placed on the line directly above a block element, or immediately before inline syntax.

Command

An instruction inside a comment tag: style:, #alias, marker:, multiline, condition:, or include:. The command is the payload; the comment tag is the container.

Combined command

Several commands in one comment tag, separated by ; — for example <!-- style:CustomTable; multiline -->. This is the only way to apply several commands to one element: stacking two comment tags leaves the upper tag without effect.

Attachment

A comment tag affects the element it is attached to — the element directly below it (block) or immediately after it (inline). A blank line between the tag and the element silently breaks the attachment.

Custom style

A style: command that overrides an element's default style name, so the element gets its own entry in Style Designer.

Alias

A #name command that gives an element a stable anchor for linking, independent of its heading text.

Condition

A named switch that shows or hides the wrapped content per output target.

Variable

A $name; token replaced with a per-target value at generation time.

Multiline table

A table, marked with the multiline command, whose cells can hold block content such as lists and code blocks. A row of empty cells — the separator row — starts a new logical row.

Content island

A blockquote with a custom style — the Markdown++ pattern for callouts, notes, and warnings.